details widget name

Handling the HTTP request

Chapter details

An incoming HTTP request to the Atlas system is usually parsed to com.tetracom.atlas.iviewer.request.api.IAtlasRequest – a system request object kept in TreadLocal in the com.tetracom.atlas.iviewer.request.processor.tl.RequestContainer. This is especially true when multiple services will be called – the case with the HtmlViewerServlet. The IAtlasRequest is a way of passing the parameters from the HTTP request to the other services responsible for rendering the business objects. The com.tetracom.atlas.iviewer.request.impl.AtlasRequest is the class that implements the IAtlasRequest interface. The AtlasRequest contains information extracted from the HTTP request or added from the servlet itself:

  • the id of the current user;

  • the id of the requested website;

  • the id of the requested page;

  • the language of the page requested;

  • the HTTP info of the original request, represented by a system com.tetracom.atlas.iviewer.request.api.IAtlasRequest.IHttp object;

  • the parameters, which the original request was carrying;

  • the mode of the request. This is a system property indicating how the content will be rendered. For instance, “zhtml” mode means that this is a request from i-Publisher's simple mode. When the mode is “preview”, the system automatically generates content to fill empty widgets, etc. The modes are listed in the com.tetracom.atlas.iviewer.request.api.IAtlasRequest.Mode enumerator. “vanilla” is the default mode.

The main services managing the AtlasRequest are the

  • com.tetracom.atlas.iviewer.request.api.service.INewRequestService – for creating a new AtlasRequest from a HTTP request;

  • com.tetracom.atlas.iviewer.request.api.service.IRequestProcessorService – for parsing the HTTP request;

  • com.tetracom.atlas.urlalias.api.IUrlAliasService – for converting a list of parameters, obtained from the HTTP request to the AtlasRequest object.